home *** CD-ROM | disk | FTP | other *** search
/ The Pier Shareware 1 / Pier Shareware 1.iso / 035a / cusrt2.exe / CUSORT.DOC < prev    next >
Text File  |  1992-02-01  |  7KB  |  169 lines
  1. |    Colorado Utilities Sort (CUSORT v.2.16)
  2. |
  3. |    by
  4. |
  5. |    Fred C. Hill
  6. |
  7. |    Micro System Solutions
  8. |    5048 W. Maplewood Ave.
  9. |    Littleton, CO 80123
  10. |    1-(303) 795-7653
  11. |    1-(800) 421-1789 (orders)
  12. | Sorting is one of those things every computer user must do at one
  13. time or another, and the sort program provided with most versions
  14. of DOS just doesn't do the job. It's slow; only sorts from column
  15. one; won't sort descending; has a limited capacity; and only uses
  16. regular memory to sort in. Not a very useful program when you have
  17. hundreds of thousands of records you want sorted in position 25 for
  18. 12 characters.
  19.  
  20. CUSort implements what is known as a virtual sort, allowing you to
  21. sort more than will fit in RAM at one time.  It does this by
  22. sorting manageable portions of the input file first, and then
  23. merging these pre-sorted lists to form the final output file.  In
  24. theory, two billion records can be sorted in one run. In actual
  25. practice, the number of records will be limited only by the amount
  26. of available disk or expanded memory (EMS) capacity, and, of
  27. course, the amount of time you're willing to wait.
  28.  
  29. CuSort Revision history
  30.  
  31. version 1.0 - February 1990  Original version
  32.  
  33. version 2.0 - August 1990
  34.           Option D Directory changed to Option R Redirect.
  35.  
  36.           Option D Added to indicate "No duplicates to be written."
  37.  
  38.           Option L added to indicate "Sort by record length."
  39.  
  40.           Bug fixed - if blank record option (/B) not selected the
  41.           program would not produce an output file.
  42.  
  43. version 2.1 - November 1990
  44.           Option E added.  Do not use Expanded memory even if available.
  45.  
  46.           At an abnormal termination CuSort now removes its work files.
  47.  
  48.           Bugs fixed - 
  49.                   Option L flag was never initialized so it could 
  50.                   be invoked at any time by leftover memory contents.
  51.  
  52.                   StdIn was not always used properly.
  53.  
  54. The D & L options were added at the request of Terry Hall of
  55. Illinois.  Thanks for the idea Terry.  This addition allowed me to
  56. find the /B option bug also.
  57.  
  58. version 2.16 - February 1992
  59.     Added the quiet mode operation (/Q) at the request of Dave Holley of 
  60.     MicroMax Computer Services Corp.
  61.  
  62. CUSort's operation is determined by the command line parameters you
  63. give it when the program is started.  The command line format is
  64.  
  65.      CuSort [options] <inputFile >outputFile
  66.  
  67.      Options:
  68.  
  69.          /-   Sort in descending order. The default is
  70.               ascending order.
  71.          /I   Ignore upper/lower case.  All input is compared
  72.               as if it were upper case.
  73.          /Q   Run in quiet mode.  No output is made to the StdErr
  74.               file. (StdErr is normally defined to the screen)
  75.          /R xx     Redirect temporary sort files to directory
  76.                    xx. (files will be deleted before program
  77.                    terminates.)
  78.          /T   Trim records. This parameter allows you to
  79.               remove blanks at the beginning and end of the
  80.               input records. Sequencing is done prior to
  81.               trimming.
  82.          /B   Do not write blank records. All blank records
  83.               found during the input phase will be discarded.
  84.          /D   Do not write duplicate records.
  85.          /L   Sort by length of record. /S parm is ignored.
  86.          /S c,l    Sort fields ... c = column; l = length. You may
  87.                    have a maximum of 6 /S fields during any single
  88.                    run. They must be placed in priority sort
  89.                    order.
  90.          /E   Do not use Expanded Memory (EMS) even if that memory
  91.               is available.
  92.  
  93.      When sorting by fields the parameter denoting descending order
  94. (/-), will result in the file being sequenced in descending order
  95. from the major sort field to the minor sort field.
  96.  
  97.      Examples:
  98.  
  99.      CuSort /B /S 1,25 < textin.dat > textout.dat
  100.           This example sorts just like the DOS sort except that the
  101.           sort field size is limited to 25 characters and any blank
  102.           records found during sorting will not be included in the
  103.           output file.
  104.  
  105.      CuSort /- /I < textin.dat > textout.dat
  106.           This example sorts the entire file, including blank
  107.           records in descending sequence. Lower case and Upper case
  108.           are sorted together.
  109.  
  110.      CuSort /- /I /S 10,5 /S 2,6 < textin.dat > textout.dat
  111.           This example sorts on column 10 for 5 characters as the
  112.           major sort field and column 2 for 6 characters as the
  113.           minor sort field. The file is sorted in descending
  114.           sequence and upper and lower case characters are sorted
  115.           together.
  116.  
  117.      CuSort /L /D /Q <textin >textout
  118.           This example will sort records by length of record and
  119.           will remove any duplicate records. Operate in quiet mode
  120.     ORDER FORM
  121.  
  122.      Name: ------------------------------------------------------
  123.  
  124.      Address: ---------------------------------------------------
  125.  
  126.      City: ---------------------------- State: ---- Zip: --------
  127.  
  128.      Phone: (     ) -------------------------------
  129.  
  130.      Credit card:   type -  Visa     Mastercard
  131.  
  132.      Card number: ------------------------------ expires ---/---
  133.      
  134.      Name on card: ---------------------------------------------
  135.  
  136. ----------------------------------------------------------------
  137.      CuSort latest version . . . . . . . . . . . . . . . $ 12.00
  138.           Includes the following..
  139.                Current disk direct from author
  140.                Laser printed documentation
  141.                Shipping and handling
  142.                Telephone support
  143.                Notification of further upgrades and
  144.                     products.
  145.  
  146.      Colorado residents include 3% state tax and 
  147.           appropriate local tax. . . . . . . . . . . . . .$ -----
  148.  
  149.  
  150.                          Total included  . . . . . . . . .$ -----
  151.  
  152.  
  153. ----------------------------------------------------------------
  154. Order in one of three ways... Fill out this form and mail to: 
  155.      Micro System Solutions
  156.      5417 S. Cimarron Rd.
  157.      Littleton, CO 80123
  158. - or -
  159.      Call 1-(800) 421-1789 or 1-(300) 795-7653 (credit card orders)
  160. - or-
  161.      Leave a Compuserve EasyPlex (Compuserve Mail) message for
  162.      Micro System Solutions (Fred C. Hill PPN 76060,102) with all
  163.      of the information above. (credit card orders or information
  164.      only please, DO NOT leave messages with credit card numbers
  165.      in the forum areas)
  166. ----------------------------------------------------------------
  167.  
  168.      
  169.